home *** CD-ROM | disk | FTP | other *** search
/ EnigmA Amiga Run 1997 February / EnigmA AMIGA RUN 15 (1997)(G.R. Edizioni)(IT)[!][issue 1997-02][PLANET CD V].iso / enigma / earcd / comm / comm1 / cnet_bak.lha / cnetamigabackup / CNetBackUp_README! < prev    next >
Text File  |  1997-01-15  |  36KB  |  796 lines

  1. ============================================================================
  2.        CNet Amiga BackUp, v3.00 README! File by Dotoran of Frontiers!
  3. ============================================================================
  4.  
  5. What is it?
  6. ~~~~~~~~~~~
  7.     This utility was written as a means of safeguarding CNet Amiga's more
  8. volatile information files, like "bbs.udata", "bbs.sdata", etc, although it
  9. has undergone numerous changes and has proven to be QUITE powerful!
  10.  
  11. System Requirements:
  12. ~~~~~~~~~~~~~~~~~~~
  13.     In order to use this program, you MUST have the following:
  14.  
  15.         CNet Amiga, v4.24f or later.
  16.           (It WILL run on v3.05c, but NOT run on EARLIER 4.xx versions!)
  17.         Arexx, v1.14 or higher.
  18.         Arexx "rexxsupport.library".
  19.         LHA, v1.38 or higher. (MUST be Named LHA & be present SOMEWHERE
  20.                                in your PATH, preferably in C:)
  21.  
  22.     And these DOS commands located somewhere in your PATH, preferably C:
  23.  
  24.             Copy        Delete      Filenote    Format
  25.             MakeDir     Protect     Rename      Sort
  26.  
  27.     The following calls are made using the "rexxsupport.library":
  28.  
  29.             SHOWDIR()       SHOWLIST()      STATEF()
  30.  
  31.     If you are lacking any of the above files, then you will NOT be able to
  32. use this program. None of these files are "out of the ordinary" which means
  33. you should already have these programs and files if you are running CNet to
  34. it's fullest potential.
  35.  
  36.     When I say the files must be available in your "PATH", I'm referring them
  37. to be located in one of the directories specified in one or more PATH state-
  38. ments located in your "startup" files when your system boots up. Since it is
  39. possible to have MULTIPLE path commands listed amongst these files, you can
  40. type PATH, with no arguments from inside a CLI-Shell window to list ALL the
  41. currently PATH'ed directories. Provided you see the directory that houses the
  42. needed files above within this listing, you'll be all set. If, however, you
  43. do NOT see one or more directories listed, then I suggest you COPY the files
  44. INTO one of the directories you DO see listed. (Do NOT MOVE the files, just
  45. in case some OTHER program is written to find them in the original location!)
  46.  
  47.  
  48. WARNING:
  49. ~~~~~~~
  50.     This program has the potential to be VERY DANGEROUS if used by one who
  51. does not know what they are doing, or one who shouldn't be using it anyways,
  52. so please SAFEGUARD this program in a directory available only to YOU in your
  53. DOORS: area, or better yet, don't add this file to your DOORS: at all...
  54.  
  55.     Instead, add it as a SysOp Only Command which is only known to YOU and
  56. those you trust. The old saying, "Out of sight, out of mind" is worth NOTING
  57. (REMEMBERING) where this program is concerned!
  58.  
  59.     It is also recommended that you NOT allow this file to be used REMOTELY,
  60. as their ARE possibilities something unforseen may need your attention, like
  61. running out of memory, etc. For this reason, I did NOT include any Loss of
  62. Carrier checks in either routine. Perhaps if you come home someday to see
  63. the port hanging, because someone used it remotely and lost carrier that you
  64. will REMEMBER to NOT allow users to use this from remote.
  65.  
  66. OK, So How Do I Use It?
  67. ~~~~~~~~~~~~~~~~~~~~~~
  68.     Well, to start with, you should have two Arexx files in this archive:
  69.  
  70.         CNetAmigaBackUp/CNetBackUp  - The SysOp Maint Module.
  71.         CNetAmigaBackUp/CNetBackUpA - The AutoMaint Module.
  72.  
  73.     You should place the "CNetAmigaBackUp/" directory somewhere in your BBS.
  74. I have mine in the "DOORS:" directory, but you can have yours wherever you 
  75. wish.
  76.  
  77.     You should then add the "CNetBackUpA" file as an EVENT that will be RUN
  78. every night. Settings might look like these:
  79.  
  80.                 Name: CNetBkUP                  Event Type: RunARexx
  81.              Port(s): 0
  82.         Execute Date: Tommorrow at 03:30    (Run at 3:30 AM)
  83.               Invoke: Immediate-UDump
  84.          Repeat Days: 1                     (Run ONCE a day)
  85.         Repeat Hours: 0
  86.          Repeat Mins: 0
  87.           Valid Time: 01:00                 (Between 3 and 4 AM)
  88.               Status: Ready
  89.        Unloaded Port: Ignore
  90.               Checks: Mark ALL SEVEN        (Run EVERY Day)
  91.  
  92.              Command: <path>CNetAmigaBackUp/CNetBackUpA
  93.  
  94. NOTE: Replace <path> with the location you decided to store the included
  95.       "CNetAmigaBackUp/" directory. 
  96.  
  97. NOTE: This version currently does NOT allow for the AMaint module to create
  98.       a BackUp MORE than ONCE in a given day, however YOU can run backup as
  99.       often as you wish using the SysOp BackUp module. For this reason, you
  100.       should NOT attempt to create the above event to "hit" more often than
  101.       once a day. (If you do, nothing adverse will occur, but nothing will
  102.       be backed up each successive time it runs either).
  103.  
  104.     You should now add the following command to the bottom of Menu # 1, your
  105. Maintenance Menu:
  106.  
  107.         CNB, CNet Backup    |   {#1<path>CNetAmigaBackUp/CNetBackUp}
  108.                                 ^ `---------.
  109.                              Control-Q      |
  110.                                           Exclusive Use ARexx PFile
  111.  
  112. NOTE: Replace <path> with the location you decided to store the included
  113.       "CNetAmigaBackUp/" directory. 
  114.  
  115. NOTE: Although it is also possible to launch this file from within a "Pfiles"
  116.       or "Doors" section of the bbs, it is HIGHLY recommended that you do
  117.       NOT do this. It's better that your users do NOT know that such a file
  118.       exists...
  119.  
  120. OK, Using CNetBackUp:
  121. ~~~~~~~~~~~~~~~~~~~~
  122.     When you first run the "CNetBackUp" file, you'll see a little message
  123. about the CONFIG file not being present. This is only temporary as it will 
  124. be created soon. Just press any key to enter the file.
  125.  
  126.     On the MAIN Menu of the program, you'll see nine choices:
  127.  
  128. <E> Edit File Parameters
  129.  
  130.     - Lets you modify several items of data which define how your BackUp
  131.       File will operate. (More on this in a bit)
  132.  
  133. <M> Modify File Lists
  134.  
  135.     - Lets you modify the list of files that will be Backed Up when this
  136.       BackUp File is used. Each data item consists of both the PATH and
  137.       FILENAME of the file to be Backed Up.
  138.  
  139. <A> Add  a BackUp File
  140.  
  141.     - Lets you add a NEW BackUp File to those that already exist. If this
  142.       is your first time using CNetBackUp, pressing either "E" or "M" above
  143.       will both have the same affect as this option.
  144.  
  145. <K> Kill a BackUp File
  146.  
  147.     - Allows you to remove a BackUp File you will no longer be using. 
  148.  
  149. <L> Log Viewer
  150.  
  151.     - Allows you to view the "log" of one of the backup files. This log is
  152.       created whenever one of the backup files is used and will contain the
  153.       integrity test output from LHA as well as some info on WHEN the archive
  154.       was created and IF any MISSING files were present in the backup list.
  155.  
  156.     - When AMaint processes a BackUp file, it will send the log to the SysOp
  157.       that holds account ID # 1 as a piece of email.
  158.  
  159. <C> Create Archive
  160.  
  161.     - This command allows you to "on the fly" create an LHA archive that can
  162.       then be sent to a user on the bbs. You'll be asked for a filename and
  163.       location for the archive and will then be taken into the ADD FILES
  164.       routine(more on this below). When finished ADDING files, when you select
  165.       SAVE, you'll be asked for the ID, Handle or Real Name of a user on your
  166.       bbs. If you supply this info, provided it's valid, a piece of email
  167.       will be sent to this user with the newly created archive attached to
  168.       the mail.
  169.  
  170. <F> Floppy Drives (DF0: DF1:, etc.)
  171.  
  172.     - This program will allow you to FORMAT a floppy disk that may be used
  173.       as the DESTINATION for your BackUp file, but in order to do this, the
  174.       program needs to know WHICH & HOW MANY floppy drives your system has.
  175.       Pressing "F" will read the currently defined floppy drives for your
  176.       system. The program will NOT let you choose FORMAT unless your
  177.       designated DESTINATION is the same as one of the drives listed here.
  178.  
  179. <B> BackUp CNet Now
  180.  
  181.     - Will allow you to activate one of the BackUp Files, without having to
  182.       wait for the "CNetBackUpA" file to do it. You'll be asked which BackUp
  183.       File you wish to use, then the BackUp will begin. Upon completion, the
  184.       BackUp File START DATE will also be updated, so the "CNetBackUpA" file
  185.       doesn't repeat what you just did, until the interval has elapsed.
  186.  
  187. [Q] Quit CNet BackUp
  188.  
  189.     - Does precisely that, no questions asked! (Pressing RETURN/ENTER will
  190.       also activate the QUIT function).
  191.  
  192. Some of the above menu items take you to other screens that contain even
  193. MORE data items. These "extended" screens are described below:
  194.  
  195. Add/Edit File Parameters:
  196. ~~~~~~~~~~~~~~~~~~~~~~~~
  197.     Both of these items use a similar screen, which contains the following:
  198.  
  199. File Extension
  200.  
  201.     - This is an extension from 1 to 3 characters that will be used to name
  202.       the BackUp file. The format for a BackUp filename is:
  203.  
  204.         - CNetBackUp.???   <--- Where the ??? is your chosen EXTENSION.
  205.  
  206.         - This file is stored inside the "CNetAmigaBackUp/" directory.
  207.  
  208.         - The extension "CFG" is reserved for the CNetBackUp CONFIG file.
  209.  
  210.         - The actual LHA'ed BackUp file will ALSO follow a similar format:
  211.  
  212.                 - CNetBackUp_???.LHA   <--- Where ??? is your EXTENSION.
  213.  
  214.         - Pressing ENTER/RETURN with nothing in the string gadget will use
  215.           "BAK" as the default extension.
  216.  
  217. BackUp Description
  218.  
  219.     - This text is simply used as a description for this BackUp File. It is
  220.       only used by the program as a means of describing which File is being
  221.       used for any given action. No filenames are based on this name.
  222.  
  223.     - Pressing ENTER/RETURN when empty here will use text of the format:
  224.  
  225.             "BackUp File # ???"    where ??? will be the next numbered file.
  226.  
  227. TEMP/WORK Path
  228.  
  229.     - This should be the location of a FIXED, EMPTY directory. By FIXED, I
  230.       mean this should be a directory which will never be deleted. By EMPTY,
  231.       I mean you should NEVER store any of your OTHER files in this directory,
  232.       as the BackUp program will DELETE all the contents of this directory
  233.       upon the completion of any BackUp task. There is a directory titled
  234.       "BackUp/" which resides INSIDE the "CNetAmigaBackUp/" directory that
  235.       I would recommend you use for the TEMP path, but the choice is yours!
  236.       It is NOT a good idea to use a directory in RAM:, as you may find you 
  237.       do not have enough RAM to store all the files you wish to back up!
  238.  
  239.     - If you press ENTER/RETURN in this string gadget when empty, and if the
  240.       "CNetAmigaBackUp/BackUp/" directory exists, it will be the default used.
  241.  
  242. DESTINATION Path
  243.  
  244.     - This is the location where the LHA packed BackUp file will be placed
  245.       after it has been created. It was suggested above that you place this
  246.       file on a FLOPPY disk, in the event you have a Hard Drive Crash, which
  247.       might take out your ENTIRE partition. This way, at least you'll have
  248.       your data on FLOPPY to help in your rebuilding!
  249.  
  250.     - If you wish NOT to use a Floppy Disk for your BackUp storage location,
  251.       then I'd HIGHLY recommend you specify a directory that exists on a
  252.       different HARD DRIVE or a different PARTITION than the one you're using
  253.       to store your CNET: assigned directory. (It won't help much if you LOSE
  254.       your CNET: drive and your BACKUP was on there as well!)
  255.  
  256.     - NOTE: For both the TEMP/WORK Path, and the DESTINATION Path, it is not
  257.             absolutely necessary to end each entry with a /. Your system will
  258.             be scanned to see if a directory by this name actually exists,
  259.             and if so, the "/" will be appended automatically, however if the
  260.             program cannot locate the stated path, you'll be told this! If,
  261.             however, you'll be using an ASSIGN that ENDS with a COLON, you
  262.             MUST supply the COLON or the program will attempt to locate a
  263.             file by this name.
  264.  
  265.     - Pressing ENTER/RETURN when the gadget is empty will use the first drive
  266.       found on your system(as shown in the Floppy Drives section on the Main
  267.       Menu)
  268.  
  269. Interval in Days
  270.  
  271.     - This is the number of days between individual BackUps of data housed
  272.       within this file. Set to "1" and this data will be Backed Up every
  273.       night. Set to "7" and the data is Backed Up every week, etc.
  274.  
  275.     - The value of "1" will be used if ENTER/RETURN is pressed when the string
  276.       gadget is empty.
  277.  
  278.     - Note that this version does NOT have the ability to create BackUps MORE
  279.       often than ONCE a day. If you feel the file SHOULD have this ability,
  280.       please drop me a line and I'll add it in.
  281.  
  282. Create Directories
  283.  
  284.     - This is a NEW feature to v3.00. In previous versions of this program,
  285.       a directory structure was created in the TEMP path and the files to be
  286.       backed up were COPIED into these directories. Once all directories had
  287.       been created and all files had been copied, the LHA archiver was then
  288.       activated to archive the TEMP directory.
  289.  
  290.     - If you specify NO to this option, the separate directory structure will
  291.       NOT be created, NOR will the files be COPIED into the TEMP folder.
  292.       Instead, the paths and filenames of the original locations will be used
  293.       to archive the files directly from their point of origin. This option
  294.       can DRAMATICALLY speed up a BackUp operation.
  295.  
  296. Arc to Destination
  297.  
  298.     - Another NEW 3.00 option is the ability to have the archive CREATED
  299.       directly in the Destination path, insteaad of first being created in
  300.       the TEMP path, then COPIED over to the Destination path. If you're
  301.       sure the resultant archive won't be too big to fit in the destination
  302.       path(ie, if that happens to be a floppy disk), then specifying YES to
  303.       this option will squeak a bit more speed from the program.
  304.  
  305. Format Dest Path
  306.  
  307.     - Provided you defined your DESTINATION PATH above as a FLOPPY DRIVE,
  308.       you can have the "CNetBackUp" program FORMAT the Floppy Drive BEFORE
  309.       the packed file is copied to it. This allows you to make sure the
  310.       disk has enough room in which to store the BackUp.
  311.  
  312.     - If you specify YES, you'll then additionally be asked if you wish the
  313.       disk to be FULLY formatted or QUICK formatted. The QUICK format will
  314.       only be successfull on a disk that has been previously formatted.
  315.  
  316.     - Pressing ENTER/RETURN here will NOT format the disk.
  317.  
  318. On the "Edit File Parameters" screen, on the top line, you'll be shown both
  319. the FILENAME of the Config File, as well as the date the AMAINT Module last
  320. backed this file up.
  321.  
  322. Last BackUp Date
  323.  
  324.     - Only found on the EDIT screen, this allows you to CHANGE when the "A"
  325.       module will next backup your info.
  326.  
  327.     - If you want to make it backup today, first note the number of interval
  328.       days, then change this date so that it's that number of days into the
  329.       past. This file will be used to perform a backup today during AMAINT.
  330.  
  331. Edit File Contents:
  332. ~~~~~~~~~~~~~~~~~~
  333.     This is the screen where you define WHICH files and at WHICH paths you
  334. wish to be Backed Up using this BackUp File. The screen is formatted to only
  335. allow 15 items to be shown at one time. A "bar" menu at the bottom of the
  336. screen will show you the available commands:
  337.  
  338. <A>dd
  339.  
  340.     - Allows you to ADD files to the list. This routine is quite powerful in
  341.       itself, because files can be added in numerous ways:
  342.  
  343.         - You can press RETURN to scan ALL files located in your CNET: Root
  344.           directory path, pressing "Y" to Add, "N" to Skip, "A" for ALL FILES,
  345.           or "Q" to Quit.
  346.  
  347.         - The new "L" for Last command will ADD the currently selected item,
  348.           then QUIT the add process(like pressing Y followed by Q).
  349.  
  350.         - You can specify the entire string,  like "sysdata:bbs.udata"
  351.  
  352.         - You can specify just the directory, like "sysdata:"
  353.  
  354.             - ALL Files within "sysdata:" will be scanned. Each will be
  355.               shown one at a time. You can select YES to ADD that file,
  356.               NO to SKIP that file, ALL to ADD ALL FILES in this directory
  357.               AFTER the last file presented to you, LAST to ADD this file
  358.               and quit, or QUIT to END the ADDING procedure.
  359.  
  360.         - You can use the "*" WILD CARD Character in three ways:
  361.  
  362.             - like this: "sysdata:bbs.*"
  363.  
  364.                 - ALL Files within "sysdata:" STARTING with "bbs.", like:
  365.  
  366.                     bbs.udata, bbs.ukeys3, bbs.cuser, bbs.sam, etc....
  367.  
  368.             - like this: "sysdata:*data"
  369.  
  370.                 - ALL Files within "sysdata:" ENDING with "data", like:
  371.  
  372.                     bbs.udata, bbs.idata, bbs.sdata, bbs.adata, etc....
  373.  
  374.             - like this: "systext:menu/*se*"
  375.  
  376.                 - ALL Files within "systext:menu/" CONTAINING "se", like:
  377.  
  378.                     base, base0, browse, udbase, udbase0, vised, etc....
  379.  
  380. <K>ill
  381.  
  382.     - Allows you to REMOVE (Kill) item(s) from the list. CNet PARSING is
  383.       allowed at this prompt. In other words, 1-3,7,14- would kill these:
  384.  
  385.             1 - 3  &  7  &  14 - thru the end of the list.
  386.  
  387. <E>dit
  388.  
  389.     - After specifying WHICH item(s) to Edit, you'll be given a basic CNet
  390.       string gadget containing the original path/filename data.
  391.  
  392.     - NOTE: For ALL String Gadgets in this program, the CONTROL Key can be
  393.             used in combination with other keys for added power:
  394.  
  395.             CTRL-X: Erases entire string.
  396.             CTRL-B: Goes to Beginning of string.
  397.             CTRL-N: Goes to the End of the string, etc...
  398.  
  399.          BACKSPACE: Erases character to LEFT of cursor, then moves cursor
  400.                     into that position.
  401.  
  402.             DELETE: Deletes character UNDER the cursor, then moves all
  403.                     characters to the RIGHT of the cursor ONE SPACE to the
  404.                     left. The cursor stays where it is.
  405.  
  406.     - When editing files, the procedure will only work if the NEW file you
  407.       enter ALSO exists at the given path. There are two reasons you might
  408.       want to edit a file:
  409.  
  410.             - To change to the name of some OTHER file, like:
  411.  
  412.                     systext:menu/main   changed to: systext:menu/udbase
  413.  
  414.             - To change to the FULL PATH of the given file, like:
  415.  
  416.                     systext:menu/main   changed to: cnet:systext/menu/main
  417.  
  418.     - CNet PARSING is also allowed at this prompt. You'll be asked to edit
  419.       each one in sequence. Simply press ENTER/RETURN to leave a file as it
  420.       is, and go on to the next one.
  421.  
  422. <N>ext 15
  423.  
  424.     - Will display the NEXT group of 15 items.
  425.  
  426. <P>ast 15
  427.  
  428.     - Will display the PAST group of 15 items.
  429.  
  430. <S>ave
  431.  
  432.     - Will SAVE the data, then Quit to the Main Menu.
  433.  
  434. [Q]uit
  435.  
  436.     - Will prompt you to SAVE DATA if it has been changed, then
  437.       will directly QUIT back to the Main Menu. Pressing ENTER/RETURN
  438.       will also activate the Quit command here as well as the Main Menu.
  439.  
  440. Backing Up CNet:
  441. ~~~~~~~~~~~~~~~
  442. The following paragraphs will use this BackUp File example:
  443.  
  444.    "CNetBackUp.DLY"                    BackUp File Parameters
  445.   ===============================    ============================
  446.    cnet:bbstext                        Extension   : DLY
  447.    cnet:bbsmenu                        Description : Daily BackUp
  448.    gfiles:sysops/Arexx_Commands        Temp/Work   : CNetAmigaBackUp/BackUp/
  449.    sysdata:bbs.udata                   Destination : df1:
  450.    sysdata:bbs.adata                   Interval    : 1
  451.    systext:sys.start                   Create Dirs : Yes
  452.    systext:sys.welcome                 Arc to Dest : No
  453.    systext:menu/main2                  Format Dest : No
  454.    systext:menu/editor2               ============================
  455.   ===============================
  456.  
  457. Using the above data, "CNetBackUpA" would do the following:
  458.  
  459. - Read names of each BackUp File on record, noting those whose intervals
  460.   have expired.
  461.  
  462. - UpDate the BackUp Date of each BackUp File on record.
  463.  
  464. - If this file was noted above(which we'll say was), then do the following:
  465.  
  466. - If a previous BackUp file by this name exists in the DESTINATION PATH,
  467.   then UNPROTECT and DELETE it from the DESTINATION directory.
  468.  
  469. - Create a "cnet" directory inside the "CNetAmigaBackUp/BackUp/" directory.
  470. - Copy the "bbstext" file into the "CNetAmigaBackUp/BackUp/cnet/" directory.
  471.  
  472. - Create a "gfiles" directory inside the "CNetAmigaBackUp/BackUp/" directory.
  473. - Create a "sysops" directory inside the "CNetAmigaBackUp/BackUp/gfiles/" directory.
  474. - Copy "Arexx_Commands" file into the "CNetAmigaBackUp/BackUp/gfiles/sysops/" directory.
  475.  
  476. - Create a "sysdata" directory inside the "CNetAmigaBackUp/BackUp/" directory.
  477. - Copy the "bbs.udata" file into the "CNetAmigaBackUp/BackUp/sysdata/" directory.
  478.  
  479. - Copy the "bbs.adata" file into the "CNetAmigaBackUp/BackUp/sysdata/" directory.
  480.  
  481. - Create a "systext" directory inside the "CNetAmigaBackUp/BackUp/" directory.
  482. - Copy the "sys.start" file into the "CNetAmigaBackUp/BackUp/systext/" directory.
  483.  
  484. - Copy the "sys.welcome" file into the "CNetAmigaBackUp/BackUp/systext/" directory.
  485.  
  486. - Create a "menu" directory inside the "CNetAmigaBackUp/BackUp/systext/" directory.
  487. - Copy the "main2" file into the "CNetAmigaBackUp/BackUp/systext/menu/" directory.
  488.  
  489. - Copy the "editor2" file into the "CNetAmigaBackUp/BackUp/systext/menu/" directory.
  490.  
  491. - If enabled, FORMAT the DESTINATION directory appropriately.
  492.  
  493. - Using LHA, pack the contents of the "CNetAmigaBackUp/BackUp/" directory.
  494.  
  495. - Copy the "CNetBackUp_DLY.LHA" file to the "DF1:" drive.
  496.  
  497. - Create a COMMENT for the LHA file listing the date & time of creation.
  498.  
  499. - PROTECT this file from WRITEOVERS and DELETIONS, using Attributes.
  500.  
  501. - Delete the contents of the "CNetAmigaBackUp/BackUp/" directory.
  502.  
  503. - Create a log of the LHA testing of the "CNetBackUp#?" file just created
  504.   (and also send SysOp ID # 1 the same through email) using the filename
  505.   of the archive, minus the .LHA.
  506.  
  507. - Completed!
  508.  
  509. As you can see, quite a lot has gone on. Here's a file tree to show you how
  510. the data was stored in the "CNetAmigaBackUp/BackUp/" directory:
  511.  
  512. CNetAmigaBackUp
  513.  ÀÄÄBackUp
  514.      ÃÄÄcnet
  515.      ³   ÃÄÄbbstext
  516.      ³   ÀÄÄbbsmenu
  517.      ÃÄÄgfiles
  518.      ³   ÀÄÄsysops
  519.      ³       ÀÄÄArexx_Commands
  520.      ÃÄÄsysdata
  521.      ³   ÃÄÄbbs.udata
  522.      ³   ÀÄÄbbs.adata
  523.      ÀÄÄsystext
  524.          ÃÄÄsys.start
  525.          ÃÄÄsys.welcome
  526.          ÀÄÄmenu
  527.              ÃÄÄmain2
  528.              ÀÄÄeditor2
  529.  
  530. As you can see, the format looks SIMILAR to, but not EXACTLY the way the
  531. same files appeared within the actual CNET: directory. If your intent is to
  532. create the output in CNET format, the BackUp File would need to undergo some
  533. slight changes. Here's how it, and the resultant tree would look:
  534.  
  535. "CNetBackUp.DLY"                    CNetAmigaBackUp
  536. ==================================   ÀÄÄBackUp
  537. cnet:bbstext                             ÀÄÄcnet
  538. cnet:bbsmenu                                 ÃÄÄbbstext
  539. cnet:gfiles/sysops/Arexx_Commands            ÃÄÄbbsmenu
  540. cnet:sysdata/bbs.udata                       ÃÄÄgfiles
  541. cnet:sysdata/bbs.adata                       ³   ÀÄÄsysops
  542. cnet:systext/sys.start                       ³       ÀÄÄArexx_Commands
  543. cnet:systext/sys.welcome                     ÃÄÄsysdata
  544. cnet:systext/menu/main2                      ³   ÃÄÄbbs.udata
  545. cnet:systext/menu/editor2                    ³   ÀÄÄbbs.adata
  546. ==================================           ÀÄÄsystext
  547.                                                  ÃÄÄsys.start
  548.                                                  ÃÄÄsys.welcome
  549.                                                  ÀÄÄmenu
  550.                                                      ÃÄÄmain2
  551.                                                      ÀÄÄeditor2
  552.  
  553.     Notice the difference? Full paths starting with "cnet:" are used to get
  554. a true CNet output, so why bother with the initial way in the first place?
  555. Well, for my own purposes, there are times I may only wish to BackUp the
  556. contents of say, a particular GFILE directory or PFILE directory, in which
  557. case the full CNET path structure would not be needed. It's totally up to
  558. YOU how you wish to structure your output BackUp files!
  559.  
  560. -=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-
  561.  
  562. Tricks & Tips:
  563. ~~~~~~~~~~~~~                   (1)
  564.  
  565.     First, a tip on WHAT to BackUp. You don't want to BackUp EVERYTHING in
  566. your CNET: directory, only those files that would be HARD to replace.
  567.  
  568.     Files you WOULDN'T want to include might be:
  569.               ~~~~~~~~
  570.         - Any "C" format CNet Command files, like "bbs", "load", etc.
  571.                 (These files are located on your CNet Disk Anyways)
  572.  
  573.         - Any UPLOADED files in your udbase partitions.
  574.                 (Face it, here's the BIGGEST HD User on your System. If
  575.                  worse comes to worse, let your USERS refill this area)
  576.  
  577.         - Any COMMAND files used for PFILES. By this I mean, don't bother
  578.           Backing up the actual programs, but you might want to back up the
  579.           prospective "Players/" directories, etc.
  580.  
  581.         - Lastly, don't bother with any files you KNOW you can pick up from
  582.           another source without any trouble, like utilities, pfiles, etc.
  583.  
  584.     Files you WOULD want to BackUp would be:
  585.               ~~~~~
  586.         - ANY files dealing with USER DATA. This could be from CNet itself,
  587.           like the "bbs." files in SysData: to the "Players/" directories in
  588.           your favorite PFILE games directories, etc.
  589.  
  590.         - ANY files initially created the first time you set CNet up. This
  591.           would be things like "bbs.adata", the file that holds the Access
  592.           Group Data, "bbs.avalid", the auto-validation file, "bbsevents",
  593.           the event scheduler data file, etc.
  594.  
  595.         - Your "bbstext" and "bbsmenu" files, which almost EVERY SysOp has
  596.           modified in ONE way or another!
  597.  
  598.         - ANY custom screens, menus, or other text files. These could be
  599.           anything from ".start", ".end" files, "SysText:Menu/" files,
  600.           or "SysText:New/" new user question/sysop question files, etc.
  601.  
  602. ----------------------------------------------------------------------------
  603.                                 (2)
  604.  
  605.     If you'll be using multiple BackUp files, create them in descending
  606. interval order, then enable formatting on the highest interval file. Here's
  607. what I mean:
  608.  
  609. You have three files:   MONTHLY, WEEKLY, and DAILY.
  610.  
  611.     In the course of one week, 8 files will have been saved to the floppy.
  612. (7 DAILY's and 1 WEEKLY)
  613.  
  614.     In the course of two weeks, 16 files, three weeks, 24 files.  When
  615. the end of the month rolls around, 33 write operations will have occurred
  616. on the floppy. By ReFormatting the disk every month, the bit map blocks
  617. can be restarted, so you won't run into fragmented memory errors later!
  618.  
  619. ----------------------------------------------------------------------------
  620.                                 (3)
  621.  
  622.     It's a good idea to keep a couple copies of the same file stored in
  623. different locations in case one gets corrupted.
  624.  
  625.     You could create two copies of the same BackUp File, only change the
  626. DESTINATION of each. You could then offset them by a week. This way, file 1
  627. would be created the first week in location A, then file 2 would be created
  628. a week later and stored in location B, then back to file 1 at the end of
  629. the third week and so on.
  630.  
  631.     The reason I'm mentioning this is that there were a couple times I can
  632. remember QB'ing my Hard Drive(which takes anywhere from 4 to 6 hours), only
  633. to have the day come when I NEED those QB'ed files, but they were corrupted!
  634.  
  635. ----------------------------------------------------------------------------
  636.                                 (4)
  637.  
  638.     Also included within this archive is a file called "CNetBackUp.EXA".
  639. This is an EXAMPLE BackUp File you may wish to use to initially get started
  640. with using this program. To use this file, ADD a BackUp File and enter this
  641. data:
  642.         Extension   : EXA
  643.         Description : Example BackUp
  644.         Temp/Work   : <path>CNetAmigaBackUp/BackUp/
  645.         Destination : DF1:
  646.         Interval    : 7
  647.         Create Dirs : No
  648.         Arc to Dest : No
  649.         Format Dest : No
  650.  
  651.     Now, when using the "M" command, you'll be shown the data in this file.
  652. You can choose to KILL, ADD, or EDIT any of the file/paths within this file
  653. to make it work on your system. Furthermore, using the "E" command from the
  654. Main Menu will allow you to change the above data as well. This example file
  655. contains the paths to most of the REALLY important CNet Data Files. It was
  656. included in the hope that it will make it that much easier to get this file
  657. up and running on your systems.
  658.  
  659.     There's also another file, "CNetBackUp.1ST", which contains only four
  660. small files. You could choose to add this file if you wanted to see what
  661. happens when you choose the "BackUp CNet Now" option. Use "1ST" as the
  662. extension and use the same info as shown above for the rest of the info.
  663.  
  664. ----------------------------------------------------------------------------
  665.                                 (5)
  666.  
  667.     This last section is simply a listing of files contained within a CNet
  668. Bulletin Board System, as well as a description of WHAT the file does, or
  669. is used for. You can then use this info in determining how OFTEN you'd like
  670. the data contained within these files backed up:
  671.  
  672. In the CNET: path...
  673.        ~~~~~
  674.   !bbsmenu_stock - Unchanged original bbsmenu file.
  675.   !bbstext_stock - Unchanged original bbstext file.
  676.   bbsconfig.def  - Default "empty" config settings file.
  677.   bbsconfig4     - Contains data editable via the CNet CONFIG executable.
  678.   bbscontrol3    - Contains data editable via the Control Panel & Menus.
  679.   bbsechos4      - Contains the FTN Network data editable by CONFIG.
  680.   bbslicense     - Your PROOF you OWN a legitimate copy of CNet Amiga.
  681.   bbsmenu        - Text file listing ALL available COMMANDS in CNet Amiga.
  682.   bbsnodes       - Lists Net Address Info, like Zones, Regions, Points, etc.
  683.   bbsport1       - Lists Modem Information, editable in CNet CONFIG's Modems.
  684.   bbsroom0       - Default data for Conferences Lobby room.
  685.   bbsroutes      - Electronic EMail Routing Info(from FTN Networks in CONFIG)
  686.   bbstext        - Text file listing 99% of all TEXT displayed within CNet.
  687.  
  688. In the SysData: path...
  689.        ~~~~~~~~
  690.   bbs.adata      - Contains your Access Group Definition Data. (EG)
  691.   bbs.sam        - Contains the System Activity Monitor data. (AM)
  692.   bbs.sdata      - Contains total calls, total users, total accounts, and
  693.                    the next available serial number to use for NEW users.
  694.   bbs.tnhost     - Contains CtelNet Node information.
  695.   bbs.udata      - User Data File (All info editable via the EA command)
  696.   bbs.uind1      - User Handle Index (for quick lookups). (POINTERS)
  697.   bbs.uind2      - User Phone  Index (also for quick lookups). (POINTERS)
  698.   bbs.ukeys4     - Contains Handles, Real Names & MailBox Names.
  699.   passwords      - Holds encrypted Password data. (Use SetPass to create)
  700.   subboards4     - Contains data on ALL subboards(message bases, file bases,
  701.                       text and door areas, etc.)
  702.  
  703. In the SysText: path...
  704.        ~~~~~~~~
  705.   badnames       - Do NOT allow handles containing these texts...               
  706.   badnumbers     - Do NOT allow phone numbers containing these patterns...
  707.   noises         - The <actions> used in Conference (JOIN).
  708.   sys.avalid     - Your Auto Validation parameters for NEW user signups.
  709.   sys.conf       - The intro displayed when a user enters Conference(JOIN).
  710.   sys.countries  - Info displayed when a user edits the COUNTRY they live in.
  711.   sys.end        - Text displayed when a user logs off the bbs(when NOT !).
  712.   sys.info       - Text displayed when the user uses the INFO command.
  713.   sys.private    - If NO NEW USERS is checked in Control Panel, this file is
  714.                       displayed to anyone who types NEW when logging on.
  715.   sys.start      - Text displayed by default when a user logs on.
  716.   sys.welcome    - Text displayed AFTER user makes a successful logon.
  717.   tt0.start      - Text displayed to Ascii users upon logging on.
  718.   tt1.start      - Text displayed to Amiga Ansi users upon logging on.
  719.   tt2.start      - Text displayed to IBM Ansi users upon logging on.
  720.   tt3.start      - Text displayed to C64 users upon logging on.
  721.   tt4.start      - Text displayed to Sky Pix users upon logging on.
  722.   yankend        - When a NonQWK type YANK is specified, this file is added
  723.                       to the BOTTOM of the yank text file.
  724.   yankstart      - When a NonQWK type YANK is specified, this file is added
  725.                       to the BEGINNING of the yank text file.
  726.  
  727. In the Mail: path...
  728.  
  729.   CNETINBOX      - Holds the NEW local email NOT yet processed by mail-task.
  730.   CNETOUTBOX     - Holds the NEW network email NOT yet exported by toss.
  731.  
  732. In a Mail:Users/???/ path...
  733.  
  734.   FOLDERS        - Contains subfolders holding user's email messages.
  735.   _buser3        - Contains JOIN/DROP status this user chose for SubBoards.
  736.   _dict          - The user's custom Dictionary file.
  737.   _sig0          - Default Signature File to use when others are absent.
  738.   _sig3          - FidoNet Signature when HANDLES are required.
  739.   _sig4          - FidoNet Signature when REAL NAMES are required.
  740.  
  741. In a Mail:Users/???/FOLDERS/ path...
  742.  
  743.   INBOX          - Contains NEW mail this user hasn't yet seen
  744.   SENTMAIL       - Copies of mail sent by this user if Copy-Self was ON.
  745.   TRASHCAN       - Contains messages KILLED from other folders.
  746.   _plan          - General "Finger" answers viewable by ALL users(FI).
  747.   _plan_sq       - SysOp-Only "Finger" answers. SysOps get these AFTER the
  748.                       above answers when using FI as well.
  749.  
  750. In the CNET:Configs/ path...
  751.  
  752.   events.cfg     - Contains Event Data created using the CNet CRON program.
  753.   Mail-Task.cfg  - Contains data entered via the Mail-Task's GUI Menus.
  754.  
  755. In a Base?:MessageBase/data/ path...
  756.  
  757.   _Free          - Contains pointers to free address bytes in other files.               
  758.   _Headers3      - Contains titles, authors, dates of creation of messages.
  759.   _Items3        - Contains other header info displayed when reading POSTS.
  760.   _Message3      - Contains link info on locations within _Text file.
  761.   _Text          - Contains TEXT of messages created as POSTS and RESPONSES.
  762.  
  763. In a Base?:FileBase/data/ path..
  764.  
  765.   sys.entry      - Text displayed when ENTERING the base(If help~SuperUser)
  766.   sys.exit       - Text displayed when EXITING  the base(If help~SuperUser)
  767.   _Free          - Contains pointers to free address bytes in other files.
  768.   _Headers3      - Contains filenames, uploaders, dates of upload, etc.               
  769.   _Items3        - Contains other header info(# of DL's, Best CPS, etc.)
  770.   _Message3      - Contains link info on locations into the next 2 files.
  771.   _Short         - Contains the TEXT used for SHORT DESCRIPTIONS of files.
  772.   _Text          - Contains the TEXT used for LONG DESCRIPTIONS of files.
  773.  
  774. ----------------------------------------------------------------------------
  775.  
  776. That's It! & Other Stuff!
  777. ~~~~~~~~~~~~~~~~~~~~~~~~~
  778.     Well, that's all there is, there ain't no more! Hehe. Actually, if you
  779. notice any quirks, bugs, etc, please call my board immediately. If there's
  780. a feature missing, let me know that too!
  781.  
  782.     Lastly, this program was NOT intended as an alternative to QuarterBack,
  783. or some other well known backup program. It is still a VERY WISE idea to
  784. use one of these "full blown" programs once every month or so, maybe even
  785. more often, if you have a very active system. This program was written in
  786. the event you DID have a HD failure. Using these BackUp files, it should be
  787. only a matter of minutes before you can get your system back up and running.
  788. This will give you the added time to get ahold of the pfiles, gfiles, bases,
  789. etc. that you may have also lost, either from a QB set, or the neighborhood
  790. bbs', etc, without having to worry about colorization, user data files,
  791. custom screens, etc...
  792.                                                                - Dotoran
  793. ============================================================================
  794.             Written by: Dotoran of Frontiers BBS (716)/823-9892
  795. ============================================================================
  796.